package com.bookrecomm.dao;

import com.bookrecomm.entity.User;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.data.jpa.repository.Query;
import org.springframework.stereotype.Repository;

import java.util.List;
import java.util.Optional;

/**
 * 用户数据访问接口
 * 提供用户相关的数据库操作方法
 */
@Repository
public interface UserRepository extends JpaRepository<User, Long> {

    /**
     * 根据用户名查找用户
     * @param username 用户名
     * @return 用户对象（可能为空）
     */
    Optional<User> findByUsername(String username);

    /**
     * 根据邮箱查找用户
     * @param email 邮箱
     * @return 用户对象（可能为空）
     */
    Optional<User> findByEmail(String email);

    /**
     * 根据手机号查找用户
     * @param phone 手机号
     * @return 用户对象（可能为空）
     */
    Optional<User> findByPhone(String phone);

    /**
     * 检查用户名是否已存在
     * @param username 用户名
     * @return 是否存在
     */
    boolean existsByUsername(String username);

    /**
     * 检查邮箱是否已存在
     * @param email 邮箱
     * @return 是否存在
     */
    boolean existsByEmail(String email);

    /**
     * 检查手机号是否已存在
     * @param phone 手机号
     * @return 是否存在
     */
    boolean existsByPhone(String phone);

    /**
     * 查询最近注册的用户列表
     * @param limit 限制数量
     * @return 用户列表
     */
    @Query(value = "SELECT u FROM User u ORDER BY u.createdAt DESC")
    List<User> findRecentUsers(int limit);

    /**
     * 查询活跃用户列表（根据登录时间）
     * @param limit 限制数量
     * @return 用户列表
     */
    @Query(value = "SELECT u FROM User u ORDER BY u.lastLoginAt DESC")
    List<User> findActiveUsers(int limit);
}
